home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / boot tools / bangermenu / bangermenu_eng.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  10KB  |  208 lines

  1. @database BangerMenu
  2. @master Banger.guide
  3. @$VER: BangerMenu_Eng.Guide 1.210 (30-Aug-95)
  4. @author "Andre
  5.  Trettin"
  6. @(c) "Banger Software"
  7. @index Index
  8. @remark A Guide to BangerMenu
  9. @node "Main" "BangerMenu Documentation"
  10. @next "WhatIs"
  11. @prev "Main"
  12.                          @{b}@{u}BangerMenu@{ub}@{uu}
  13.                  BangerMenu 1.210 (30-Aug-95)
  14. @{"What is the use of BangerMenu?" link "WhatIs" 0}    A short introduction
  15. @{"Copyright" link "Copyright" 0}                         copyright and other important things
  16. @{"System requirements" link "System" 0}               Everything you need to start BangerMenu
  17. @{"Installation" link "Install" 0}                      How to install manually
  18. @{"How to use BangerMenu" link "Usage" 0}             A short instruction manual
  19. @{"How to setup a configuration" link "config" 0}      A short description how to setup a configuration file
  20. @{"An example configuration" link "fileconfig" 0}          For a closer look at such a file
  21. @{"Error description" link "error" 0}                 Error ? Why ?
  22. @{"Contact" link "Autor" 0}                           My adress
  23. @endnode
  24. @node "WhatIs" "What is the use of BangerMenu?"
  25. @next "Copyright"
  26. @prev "Main"
  27. @{b}What is the use of BangerMenu?@{ub}
  28. With BangerMenu you can make a selection to execute batch files and to launch
  29. programs by using a graphical user interface. It is similar to MS-DOS Start
  30. menu.
  31. If you press the @{b}Caps Lock@{ub} key during the boot process a window will
  32. appear.  This window contains buttons to execute batch files and to launch
  33. programs according to the programs configuration. To execute batch files
  34. or to launch programs select one of the gadgets. If you changed your mind
  35. and you wanted to go on with your startup-sequence then press @{b}Escape@{ub} or the
  36. @{b}Q@{ub} key to quit the program.
  37. @endnode
  38. @node "Copyright" "Copyright"
  39. @next "System"
  40. @prev "WhatIs"
  41. @{b}Copyright@{ub}
  42. This programm is @{b}GIFTWARE@{ub}. If you like this programm and if you
  43. use it often you can send me an exciting postcard from you hometown
  44. or other things. @{"contact" link "Autor" 0} .
  45. If you have some good idees to make this programm better or if you found some
  46. bugs (I hope not) I would be pleased about a postcard from you.
  47. If you are writing programms too I allow you to use my code (it`s in assembler)
  48. to copy programmparts for your own programm.
  49. @{b}Use it at your own risk!@{ub}
  50. @endnode
  51. @node "System" "System requirements"
  52. @next "Install"
  53. @prev "Copyright"
  54. @{b}System requirements@{ub}
  55. To run BangerMenu you need Kickstart 2.04 or a later version. The gadtools.library
  56. has to be in your "Libs:" directory. Since library is included in your
  57. "Libs:" directory since Kickstart 2.04.
  58. @endnode
  59. @node "Install" "Installation"
  60. @next "usage"
  61. @prev "System"
  62. @{b}Installation@{ub}
  63. To install BangerMenu onto a separate disc you should copy the program BangerMenu in your
  64. @{b}:c/@{ub} directory and the configuration file in your @{b}:s/@{ub} directory.
  65. To install BangerMenu onto your hard disc you should copy the every file of the
  66. program package into a directory, for example @{fg highlight}"Work:Tools/BangerMenu"@{fg text}.
  67. This is the top of the original startup-sequence.
  68. @{b}; $VER: startup-sequence 39.9 (9.8.92)@{ub}
  69. @{b}C:SetPatch QUIET
  70. C:Version >NIL:
  71. C:AddBuffers >NIL: DF0: 15
  72. FailAt 21
  73. C:MakeDir RAM:T RAM:Clipboards RAM:ENV RAM:ENV/Sys
  74. C:Copy >NIL: ENVARC: RAM:ENV ALL NOREQ
  75. Resident >NIL: C:Assign PURE
  76. Resident >NIL: C:Execute PURE
  77. Assign >NIL: ENV: RAM:ENV
  78. Assign >NIL: T: RAM:T
  79. Assign >NIL: CLIPS: RAM:Clipboards
  80. Assign >NIL: REXX: S:@{ub}
  81. @{i}  And this are the necessary changes@{ui}
  82. ; $VER: startup-sequence @{fg highlight}40.??? (30-Aug-95)
  83. @{fg highlight}FailAt 21
  84. MakeDir RAM:T RAM:Clipboards RAM:ENV RAM:ENV/Sys@{fg text}   ;to create the T-dirctory to ram
  85. @{fg highlight}Assign >NIL: ENV: RAM:ENV@{fg text}                          ;this is needed to run
  86. @{fg highlight}Assign >NIL: T: RAM:T@{fg text}                              ;skripts by BangerMenu
  87. @{fg highlight}Assign >NIL: CLIPS: RAM:Clipboards@{fg text}
  88. @{b}<Pfad>@{ub}
  89. @{b}BangerMenu@{ub}                                         ;this will be copied to
  90. @{b}IF ERROR THEN@{ub}                                      ;startup-sequence
  91.  @{b}ENDCLI
  92. ENDIF@{ub}
  93. C:SetPatch QUIET
  94. C:Version >NIL:
  95. C:AddBuffers >NIL: DF0: 15
  96. Resident >NIL: C:Assign PURE
  97. Resident >NIL: C:Execute PURE
  98. Assign >NIL: REXX: S:@{ub}
  99. @endnode
  100. @node "usage" "How to use BangerMenu"
  101. @next "config"
  102. @prev "Install"
  103. @{b}How to use BangerMenu@{ub}
  104. BangerMenu can only be started by using the shell.
  105. If you would like to see the menu every time you boot then you have to add
  106. the parameter @{b}nokey@{ub} in your @{"startup-sequence" link "Install" 0}. This is favourable for
  107. floppy discs with more than one application or game.
  108. If you call BangerMenu without any parameters you have to press the @{b}Caps Lock@{ub} key
  109. to start the menu. If you did not press the @{b}Caps Lock@{ub} key the ordinary
  110. @{b}startup-sequence@{ub} will be executed.
  111. You can select gadgets by using your mouse as well by using your @{b}cursor@{ub}
  112. keys. With @{b}up@{ub} and @{b}down@{ub} you can select gadgets and by pressing @{b}return@{ub} you
  113. press the selected button. If you use @{b}left/right@{ub} cursor key you can jump
  114. to the top/bottom or if existing one column left/right.
  115. BangerMenu can be cancelled by pressing the @{b}close@{ub} gadget, escape or the @{b}q@{ub} key. In
  116. this case your ordinary startup-sequence will be continued.
  117. @endnode
  118. @node "config" "How to setup a configuration"
  119. @next "Fileconfig"
  120. @prev "usage"
  121. @{b}How to setup a configuration@{ub}
  122. The configuration file has to be called @{b}BangeMenu.Prefs@{ub} and needs to be
  123. stored either in the directory of the program or in your @{b}S:@{ub} drawer.
  124. example:    @{b}programname1
  125.             programpath1
  126.             programname2
  127.             programpath2
  128.             programname3
  129.             programpath3
  130.             
  131.             
  132.             
  133.             ENDE@{ub}
  134. Please note that the last line of this file has to be @{b}ENDE@{ub} (the german
  135. word for end). For further information please have a look at the
  136. configuration file of the program package.
  137. The programnames will be the titles of your gadgets. The longer they are
  138. the longer the gadget will be. In one column 17 gadget should fit.
  139. Depending on the programname up to 70 gadgets and more can be displayed.
  140. Maybe you have to add to some programpaths a @{b}Run >NIL:@{ub}.
  141. @endnode
  142. @node "fileconfig" "Example of an config file"
  143. @next "error"
  144. @prev "config"
  145. @{b}Example of an config file@{ub}
  146. @{i}CD32@{ui}                                                @{b}1. Gadgetname@{ub}
  147. @{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/CD32@{fg text}          a batch to boot CD32-CD
  148. @{i}ShapeShifter@{ui}                                        @{b}2. Gadgetname@{ub}
  149. @{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/ShapeShifter@{fg text}  there is a batch to start the MAC-Emulator
  150. @{i}Directory Opus@{ui}                                      @{b}3. Gadgetname@{ub}
  151. @{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/DOpus@{fg text}         a batch to run DOpus
  152. @{i}ADPro@{ui}                                               @{b}4. Gadgetname@{ub}
  153. @{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/ADPro@{fg text}         ADPro needs a lot of memory
  154. @{i}VT 2.74@{ui}                                             @{b}5. Gadgetname@{ub}
  155. @{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/VT2.74@{fg text}        a viruskiller for linkviren checking
  156. @{i}Shell@{ui}                                               @{b}6. Gadgetname@{ub}
  157. @{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/Shell@{fg text}         only a shell
  158. @{i}Seelenturm@{ui}                                          @{b}7. Gadgetname@{ub}
  159. @{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/Seelenturm@{fg text}    or a game
  160. @{b}ENDE@{ub}
  161. @endnode
  162. @node "error" "Error description"
  163. @next "Autor"
  164. @prev "fileconfig"
  165. @{b}Error description@{ub}
  166. Returncodes description
  167. 10   =  No errors. The program has been run without any mistakes and your
  168.         selection has be executed. This returncode is for aborting your
  169.         startup-sequence and executing a batch file.
  170. 21   =  No memory
  171. 22   =  Was not able to open library or libraries (dos, intuition,@{"gadtools" link "System" 0} )
  172. 23   =  GetVisualInfo error (Windowgraphic error)
  173. 24   =  @{"BangerMenu.Prefs" link "config" 0} could not be opened.
  174. 25   =  During the creation of the gadget a mistake has happened.
  175. 26   =  Could not open the window or could not find the task
  176. 27   =  @{"Preference" link "config" 0} are empty
  177. 28   =  Preference are empty
  178. 29   =  No MsgPort
  179. 30   =  Could not use any IORequest
  180. 31   =  Could not open input.device
  181. 32   =  Error during the parsing of the parameters
  182. @endnode
  183. @node "Autor" "Author & Adress"
  184. @next "Main"
  185. @prev "error"
  186. @{b}Author & Address@{ub}
  187.             @{fg highlight}Andre' Trettin
  188.             Duwockskamp 33
  189.             21029 Hamburg
  190.             Germany
  191.             040/7246861@{fg text}
  192. @endnode
  193. @node "Index" "Index of BangerMenu"
  194.      @{"Address" link "Autor" 0}
  195.      @{"Author" link "Autor" 0}
  196.      @{"BangerMenu.Prefs" link "config" 0}
  197.      @{"CAPS-Lock-Key" link "WhatIs" 0}
  198.      @{"Close-Gadget" link "Usage" 0}
  199.      @{"Cusorsteuerung" link "Usage" 0}
  200.      @{"ESC-Key" link "Usage" 0}
  201.      @{"Error" link "error" 0}
  202.      @{"Installation" link "Install" 0}
  203.      @{"Installationscript" link "Install" 0}
  204.      @{"Config" link "config" 0}
  205.      @{"Q-Key" link "Usage" 0}
  206.      @{"Startup-sequence" link "Install" 0}
  207. @endnode
  208.